home *** CD-ROM | disk | FTP | other *** search
/ A.C.E. 3 / ACE CD 3.iso / files / docs / crossdv6.lha / CrossDos.doc next >
Text File  |  1994-11-27  |  33KB  |  815 lines
  1.                                  CROSSDOS
  2.  
  3. Typed in by ???. Edited by PARASITE.
  4.  
  5.  
  6. INTRODUCTION
  7.      Many  computer users will find it useful, maybe even necessary to
  8.      share  data  between  different  computers  but  in this world of
  9.      multiple  computer  types,  however  there  usually ends up being
  10.      more  than  one  format of storing data on a disk.  These formats
  11.      usually  differ  in  the  way directories and files are accessed.
  12.      Sometimes  they  also  differ in the way the actual data bits are
  13.      stored   on   the   disk.   Both  instances  are  the  case  with
  14.      MS-DOS/PC-DOS  and  Atari  ST  formatted disks and standard Amiga
  15.      formatted disks.
  16.  
  17.      CrossDos  is  a software product that allows the user to read and
  18.      write  MS-DOS/PC-DOS and Atari ST formatted disks (Version 2.0 or
  19.      higher)  directly from AmigaDOS.  It fully integrates itself into
  20.      the  Amiga  operating system to allow your MS-DOS formatted disks
  21.      to  be  accessed  from virtually any utility or application, just
  22.      as any other Amiga file.
  23.  
  24. NOTE
  25.      All  further  references  to  MS-DOS  formatted  disks  also apply
  26.      to  PC-DOS  and  Atari  ST  formatted  disks  unless otherwise
  27.      specified.
  28.  
  29.      Imagine  working  on a spreadsheet file on your PC and continuing
  30.      to  work on it using your Amiga spreadsheet application  (such as
  31.      VIP  Professional, Analyze! or others ); maybe you are using a PC
  32.      version  of  WordPerfect  and  have an Amiga version as well; you
  33.      can  create  a  picture with DeluxePaint on the Amiga and view it
  34.      on  your PC using the PC version of DeluxePaint.  Many other data
  35.      sharing  can  be  done between databases, language compilers, CAD
  36.      programs, etc.
  37.  
  38.      The  following  MS-DOS  formatted  disks  types  are supported by
  39.      CrossDos :
  40.  
  41.        -  standard density 80 track 3 1/2" floppies ( 720 K)
  42.        -  standard density 80 track 5 1/4" floppies ( 720 K)
  43.        -  standard  density  80  track  5 1/4" floppies used in double
  44.           track step mode ( 360 K)
  45.        -  standard density 40 track 5 1/4" floppies ( 360 K)
  46.  
  47.      A  properly  mounted  MS-DOS device will allow you  to access any
  48.      file  on  a  MS-DOS  formatted disk as if it were any other valid
  49.      AmigaDOS  device.   Refer  to  section "MountList Example of a
  50.      MS-DOS  device"  for instructions on mounting a MS-DOS device.
  51.      You  can then proceed to use any file on the MS-DOS disk from any
  52.      application.
  53.  
  54. FEATURE SUMMARY
  55.           The following is a list of the main features of CrossDos:
  56.  
  57.        -  Integrates  MS-DOS  formatted  disks  as  part  of the Amiga
  58.           operating  system.   This  allows  the  MS-DOS  disks  to be
  59.           accessed  just like any other disk from any Amiga utility or
  60.           application.
  61.  
  62.        -  Read and write any file.
  63.  
  64.        -  Relabel the Disk name.
  65.  
  66.        -  Create directories.
  67.  
  68.        -  Rename  any  files  or directories within or across any
  69.           directories.
  70.  
  71.        -  Set file or directory dates.
  72.  
  73.        -  Set   or  reset  archive  and  write/delete  protection
  74.           attributes on any file or directory.
  75.  
  76.        -  Access files from any application file requester.
  77.  
  78.        -  MS-DOS  and PC-DOS formatted disks Versions 2.0 (and higher)
  79.           are supported.
  80.  
  81.        -  Two ACSII text filter options are provided.
  82.  
  83.        -  Disk   changes   are  sensed  automatically  (if  the  drive
  84.           provides the proper hardware signal).
  85.  
  86.        -  ".info"   file   extensions   are  supported  for  use  with
  87.           Workbench.
  88.  
  89.        -  Floppy   disk   parameters  are  sensed  automatically  (ie.
  90.           double-sided, single-sided, 8 or 9 sectors/track, etc.).
  91.  
  92.        -  Double  Track  Step Mode is availible to read/write standard
  93.           40 track floppies on an 80 track drive.
  94.  
  95.        -  Minimal  memory  (approx.  80  bytes)  is  required when the
  96.           filesystem is not accessed.
  97.  
  98.        -  "Kill"  utility  is provided to recover resources and memory
  99.           when MS-DOS File System not needed.
  100.  
  101.        -  Special  utilities  are  included  to format, copy and check
  102.           the integrity of MS-DOS disks.
  103.  
  104. HARDWARE REQUIREMENTS
  105.      CrossDos  requires  a  standard Amiga (500, 1000, 2000, 2000HD or
  106.      2500) with at least 256K bytes of memory.
  107.  
  108.      This  product  includes  a  special  device driver, "mfm.device",
  109.      for  use  with  3  1/2"  and  5  1/4" floppies.  Refer to section
  110.      "MountList  Example  of  a MS-DOS device" for configuration
  111.      instructions.
  112.  
  113. SOFTWARE REQUIREMENTS
  114.      CrossDos  requires at least AmigaDOS Version 1.2.  The product at
  115.      the  time  of  this  document has been tested under  Versions 1.2
  116.      and 1.3.
  117.  
  118.      You  must use a V1.3 compatible "mount" command.  This command is
  119.      included in this product.
  120.  
  121. MINIMUM FILES NEEDED
  122.      The following are files needed to mount a MS-DOS device.
  123.  
  124.           L:MSDOSFileSystem           -- always
  125.  
  126.           DEVS:mfm.device             -- when using floppy disks
  127.                                           (3 1/2" or 5 1/4")
  128.  
  129.           C:Mount                     -- always (V1.3 compatible)
  130.  
  131. PRODUCT LIMITATIONS
  132.      High  density  formatted disks (1.2M and 1.44M disks formatted on
  133.      the  IBM-AT  and PS/2) are incapable of being read due to current
  134.      limitations  in  the  standard  Amiga  hardware.   Currently, the
  135.      standard    Amiga   floppy   drive   hardware   is   capable   of
  136.      reading/writing  standard  density  formatted  floppies (360K and
  137.      720K) on  3 1/2" and 5 1/4" drives.
  138.  
  139.      Please   note  though,  high  density  drives  on  IBM-compatible
  140.      machines  are capable of formatting, reading and writing standard
  141.      density  formats.  This holds true for both the 3 1/2" and 5 1/4"
  142.      high  density  drives,  although the 5 1/4" drives may write data
  143.      on  a  floppy  unreliably when used in the double track step mode
  144.      (Refer  to  section  "Double  Track  Step Mode" for further
  145.      explanation).
  146.  
  147.      CrossDos CANNOT directly  execute  any  of   the  MS-DOS,
  148.      PC-DOS  or Atari ST executable files (such as .EXE or .COM files)
  149.      although  it  can   transfer  these  files  to or from the MS-DOS
  150.      disk.   To  execute  these  files  on the Amiga you would need an
  151.      emulator  program  such as the "Transformer" from Commodore which
  152.      is not provided in this product.
  153.  
  154.      CrossDos  is  not  guaranteed  to  read  or  write copy-protected
  155.      MS-DOS  disks.   It  will  probably read most of the disk, but it
  156.      cannot  "crack"  the  protection  technique  used  on  the  disk.
  157.      Writing to a copy-protected MS-DOS disk is NOT recommended.
  158.  
  159.      There  are  file  naming limits imposed by the MS-DOS disk format
  160.      of  eight alphanumeric characters for the file name and three for
  161.      the    file    extension.     Refer   to   section   "AmigaDOS
  162.      COMPATIBILITY" for further explanation.
  163.  
  164.      The  MS-DOS disk format does not allow file comments so that this
  165.      AmigaDOS function is not supported.
  166.  
  167. INSTALLATION
  168.      The  installation  instructions  for mounting an MS-DOS device on
  169.      the  Amiga  are  detailed  in  the  following sections.  A simple
  170.      program  is  included  in  this  product for standard 3 1/2" or 5
  171.      1/4" floppy drive installation.
  172.  
  173. INSTALLING THE SOFTWARE AND MOUNTLIST PARAMETERS
  174.      CrossDos   provides   a   simple   installation   program  either
  175.      executable from the CLI or the Workbench.
  176.  
  177.      To  execute  the program from the Workbench,  double-click on the
  178.      icon labeled "Install_MSDOSFS".
  179.  
  180.      To execute the program from the CLI, type the following:
  181.  
  182.           Install_MSDOSFS
  183.  
  184.      Answer   the  questions  presented  on  the  computer  screen  to
  185.      complete the installation of this product in your system.
  186.  
  187.      If  you  wish  to  modifiy  these  standard  parameters, edit the
  188.      mountlist   file   using   the   following  descriptions  of  the
  189.      parameters.
  190.  
  191. MOUNTING A MS-DOS DEVICE
  192.      Once   all  the  required  files  are  installed  in  the  proper
  193.      directories,  only  "mounting"  the  device is needed to have the
  194.      Amiga  recognize  the MS-DOS device.  The filesystem is "mounted"
  195.      by entering the command:
  196.  
  197.           mount <devicename:> FROM DEVS:mountlist.msdosFS
  198.  
  199.      The  "mount"  command  can be entered manually when needed or can
  200.      be executed in a startup routine such as "S:startup-sequence".
  201.  
  202.      If  "mounted" in a startup-sequence, it can be setup to consume a
  203.      minimal  amount  of  memory  (approx. 80 bytes) until MS-DOS file
  204.      acccess   is   required.    Refer  to  the  "Mount  ="  parameter
  205.      description in the following section.
  206.  
  207.      Once  the  device  is  successfully  "mounted", the device can be
  208.      accessed  by  any utility or application by specifying the device
  209.      name.
  210.  
  211. NOTE
  212.      Only  one MS-DOS File System is allowed to be mounted on any
  213.      one physical device.
  214.  
  215. MOUNTLIST EXAMPLE OF A MS-DOS DEVICE
  216.      The  following is an example mountlist entry for an MS-DOS device
  217.      using  the  internal  3 1/2" drive in the Amiga.  It is called by
  218.      the  name DI0: by the system.  Other units and device names
  219.      can   be   used  as  specified  by  Amiga  "mount"  command  file
  220.      parameters.
  221.  
  222.           DI0:
  223.                   /* Device-dependant mountlist parameters */
  224.               Device = mfm.device
  225.               Unit   = 0
  226.               Flags  = 1
  227.               Surfaces  = 2
  228.               BlocksPerTrack = 9
  229.               Reserved = 1
  230.               Interleave = 0
  231.               LowCyl = 0  ;  HighCyl = 79
  232.  
  233.                   /* FileSystem-dependant mountlist parameters */
  234.               FileSystem = L:MSDOSFileSystem
  235.               Stacksize = 4000
  236.               Priority = 5
  237.               GlobVec = -1
  238.               Buffers = 5
  239.               BufMemType = 0
  240.               Mount = 0
  241.               DosType = 0x4D534400
  242.                    /* = 0x4D444400  using Double Track Step Mode */#
  243.  
  244. NAME:
  245.           The  name  of  the device.  It may be any valid alphanumeric
  246.           combination  that  does  not  conflict  with  other  device,
  247.           volume  or logical names already mounted.  The name must end
  248.           in a ":" to be recognized by the "mount" command.
  249.  
  250. Device =
  251.           The  name  of the device driver code file to be used for the
  252.           particular  device  being  acccessed.   When  using a floppy
  253.           drive  device, the device driver "mfm.device" is included in
  254.           this  product  for this purpose.  Please note: the directory
  255.           "DEVS:" is assumed as the path name.
  256.  
  257. Unit =
  258.           The  physical  unit  number  of  the particular device being
  259.           acccessed.   Normally,  Unit 0 is the first unit.  For Amiga
  260.           floppy drives, Unit 0 is the internal drive.
  261.  
  262. Flags =
  263.           The  flags  needed  to  properly  initialize  the  device at
  264.           startup.   The  flags  to  be set will vary for each device.
  265.           For  the  Amiga  compatible  floppy drives, set Flags to '1'
  266.           (allow 5 1/4" drive).
  267.  
  268. Surfaces =
  269.           The   number  of  physical  surfaces  of  the  device.   For
  270.           standard   MS-DOS   floppies,   set  this  value  to  2  for
  271.           double-sided.   For  single-sided  MS-DOS floppies, set this
  272.           value to 1.
  273.  
  274. BlocksPerTrack =
  275.           The  number  of physical blocks on each track of the device.
  276.           For standard MS-DOS floppies, set this value to 9.
  277.  
  278. Reserved =
  279.           The  number  of  reserved  blocks  for  the beginning of the
  280.           partition  of the device.  For standard MS-DOS floppies, set
  281.           this value to 1.
  282.  
  283. Interleave =
  284.           The  physical  interleave  of  sectors  of  the device.  For
  285.           standard MS-DOS floppies, set this value to 0.
  286.  
  287. LowCyl =
  288.           The  physical  low  cylinder number of the beginning the the
  289.           device   partition.    To   calculate  the  LowCyl  use  the
  290.           following formula:
  291.  
  292.                LowCyl = [BLOCK_beg / (Surfaces * BlocksPerTrack)]
  293.                            (integer part only)
  294.  
  295.                BLOCK_beg = The beginning block number of the partition
  296.  
  297.                Example =>  0 = [ 0 / (2 * 9)]
  298.  
  299.           For  standard  40  or 80 track floppy drives, set this value
  300.           to 0.
  301.  
  302. HighCyl =
  303.           The  physical high cylinder number of the end the the device
  304.           partition.   To  calculate  the  HighCyl  use  the following
  305.           formula:
  306.  
  307.                HighCyl = [BLOCK_end / (Surfaces * BlocksPerTrack)]
  308.                            (integer part only)
  309.  
  310.                BLOCK_end = The end block number of the partition
  311.  
  312.                Example =>  79 = [ 1439 / (2 * 9)]
  313.  
  314.           For  standard  80 track floppy drives, set this value to 79.
  315.           For  standard  40 track floppy drives, set this value to 39.
  316.           For  standard  80  track  floppy drives used in Double Track
  317.           Step Mode, set this value to 39.
  318.  
  319. FileSystem =
  320.           The  name  of  the  FileSystem code file to be used to allow
  321.           AmigaDOS  to  access non-AmigaDOS formatted disks.  For this
  322.           product, use "L:MSDOSFileSystem".
  323.  
  324. Stacksize =
  325.           The  stack  size  needed for the file system task.  Use 4000
  326.           bytes or more if desired.
  327.  
  328. Priority =
  329.           The  priority of the file system task.  Should be at least a
  330.           priority 5.  Modify if desired.
  331.  
  332. GlobVec =
  333.           The  global  vector  of  the  file  system task.  This value
  334.           MUST be set to -1.
  335.  
  336. Buffers =
  337.           The  number  of cache buffers for the file system task.  Set
  338.           to  the  number  of  buffers  to  you  desire.   Each buffer
  339.           consumes  about  1040  bytes.   The more buffers, the faster
  340.           the  performance.   Be  aware  though,  there  is a point of
  341.           diminishing returns with more buffers.
  342.  
  343.           For  normal  sized  directories  a  value  of  5  buffers is
  344.           sufficient.   If large and/or multiple levels of directories
  345.           are  used  (ie.  greater  than  2), a value of 10 will yeild
  346.           faster   accesses.    Please   note:  The  AmigaDOS  command
  347.           "addbuffers"   will  add  more  buffers  to  the  filesystem
  348.           cache.
  349.  
  350. BufMemType =
  351.           The  type  of  memory  used  by  the  cache  buffers.  It is
  352.           recommended to set this value to 0 or 1 (PUBLIC memory).
  353.  
  354. Mount =
  355.           If  this  parameter  is  positive  (>0), the "mount" command
  356.           will  immediately  install the file system code.  Otherwise,
  357.           the  file system will be loaded when the first access to the
  358.           device  occurs.  It is recommended to set this value to 0 or
  359.           do  not include this parameter at all so that the memory for
  360.           the file system and device will not be used until needed.
  361.  
  362. DosType =
  363.           This  parameter indicates the type of file system used.  For
  364.           floppy  drives,  this value should be 0x4D534400.  For
  365.           80  track  5  1/4" drives used in the 40 track (double track
  366.           step)  mode, this value should be 0x4D444400 (Refer to
  367.           section   "Double   Track   Step   Mode"  for  further
  368.           explanation).
  369.  
  370.           Device  mountlist  terminating  character.   This  character
  371.           MUST  be present in the first column of new line to
  372.           terminate the mountlist parameters for a specific device.
  373.  
  374. NOTE
  375.           Parameters  left  out  of  the  mountlist  for a device, are
  376.           either automatically set to 0 or a default value.
  377.  
  378. 2.5  DOUBLE TRACK STEP MODE
  379.      The  Double  Track Step Mode is used to allow standard 40 track 5
  380.      1/4"  floppies  to  be read or written on 80 track floppy drives.
  381.      This  mode  can be used on 3 1/2" drives but there probably would
  382.      be no need to.
  383.  
  384.      The  Double  Track  Step  Mode  actually steps the drive head two
  385.      steps   instead   of  one.   To  set  this  mode,  the  mountlist
  386.      parameter  "Dostype =" must be set to 0x4D444400 ( MDD ).
  387.  
  388.      A  word  of  caution  must  be noted about using the Double Track
  389.      Step  Mode  on  80  track 5 1/4" drives.  The read/write heads 80
  390.      track  drives  are  half  the  width of heads on 40 track drives.
  391.      This  means  that  data  written on a 80 track drive will be read
  392.      back  at  about  half  the  signal magnitude on a 40 track drive.
  393.      Because  of  this  difference, reading data reliably may at times
  394.      be  difficult.  The device driver "mfm.device" provided with this
  395.      product  will  attempt  to  retry  reading  data  to  recover  if
  396.      possible.
  397.  
  398. SAMPLE SESSION
  399.      Place  a  3  1/2"  MS-DOS  formatted  disk in the internal floppy
  400.      drive  (unit  0)  in  the Amiga.  From the CLI, try the following
  401.      commands:
  402.  
  403.           mount DI0: FROM DEVS:mountlist.msdosFS
  404.  
  405.           dir  DI0: ALL
  406.  
  407.           dir  DI0:subdir
  408.  
  409.           type DI0:subdir/filename
  410.  
  411.           cd   DI0:subdir
  412.  
  413.           type filename
  414.  
  415.           info
  416.  
  417.           copy DI0:filename to DF0:
  418.  
  419.           cd   DF0:
  420.  
  421.           ----- etc.
  422.  
  423.      Try  reading  in a file from the MS-DOS device from your favorite
  424.      editor,  spreadsheet,  database,  paint or draw programs and many
  425.      other uses.
  426.  
  427. NOTE
  428.           Applications  that  bypass AmigaDOS for file access will not
  429.           be  able to  access MS-DOS formatted files.  Applications of
  430.           this  type  are  "format",  "diskcopy"  and  AmigaDOS sector
  431.           editors.
  432.  
  433. AMIGADOS COMPATIBILITY
  434.      The  MS-DOS  File  System  is designed to conform to AmigaDOS and
  435.      MS-DOS  file  naming  conventions  wherever  possible  as well as
  436.      multi-tasking  requirements  (such  as  file locks).  There are a
  437.      few  exceptions  due  to  the  limitations  of MS-DOS file naming
  438.      conventions.  The following sections detail the differences.
  439.  
  440. FILE NAMING CONVENTIONS
  441.      File  naming conventions for MS-DOS still apply when accessing or
  442.      creating file or directory names.
  443.  
  444. INVALID CHARACTERS ("FileName")
  445.      The  following  is  a  list  of characters that are not valid for
  446.      MS-DOS names.
  447.  
  448.           < > . " | + = ; ,
  449.  
  450.      Although   some  of  these  characters  are  valid  for  AmigaDOS
  451.      filenames, avoid them.
  452.  
  453.      The  characters  '\', '/', '[', ']', ':' are reserved for special
  454.      use described below.
  455.  
  456. FILE NAME ("FileName")
  457.      The   file   (directory)   name  is  limited  to  8  alphanumeric
  458.      characters.    Any   characters   beyond   8  are  ignored.   The
  459.      characters  can  be  specified as lowercase and will be converted
  460.      to  uppercase  automatically.  The space character ' ' is allowed
  461.      between   other   alphanumeric   characters   but   it   is   not
  462.      recommended.
  463.  
  464. DI0:FILENAME ignored =>  DI0:FILENAME
  465.  
  466. FILE EXTENSION (".Ext")
  467.      The  file  (directory)  extension  is  limited  to 3 alphanumeric
  468.      characters.   Any characters beyond 3 are ignored.  The extension
  469.      appears  after  the  dot  ('.') but it is not necessary in a file
  470.      name.   The  characters can be specified as lowercase and will be
  471.      converted  to  uppercase  automatically.  The space character ' '
  472.      is  allowed  between  other alphanumeric characters but it is not
  473.      recommended.
  474.  
  475.      If  multiple extensions are present in a file name, only the last
  476.      extension will be used.
  477.  
  478.  
  479.           DI0:FILENAM mignored.ign.EXT ignored =>  DI0:FILENAME.EXT
  480.  
  481. WORKBENCH EXTENSION (".info")
  482.      One   exception  to  the  3  character  extension  is  the  Amiga
  483.      extension  ".info".   When  the file name is read from the MS-DOS
  484.      disk   by  the  MS-DOS  File  System,  an  ".INF"   extension  is
  485.      automatically  expanded  to ".info" to allow the file to  be seen
  486.      by  the  WorkBench  application.   Subsequently,  when  a file is
  487.      written  to  the  MS-DOS  disk  with  an ".info" extension, it is
  488.      stored on the disk as ".INF".
  489.  
  490.      The  original  file  that  will  have  a  WorkBench  ".info" file
  491.      associated  with  it  must  not  have any other extensions in the
  492.      name.   If the original file already has an extension, it may not
  493.      be properly accessed by WorkBench.
  494.  
  495. ROOT NAME QUALIFIER (':')
  496.      The  character  ':'  is used as a root name qualifier to refer to
  497.      the   physical  device  name  or  volume  name of the disk or the
  498.      logical name of a directory path.
  499.  
  500.           DI0:FILENAME.EXT
  501.  
  502. VOLUME NAME ("Volume_Name")
  503.      The  volume  name  is  limited to 11 alphanumeric characters with
  504.      spaces  allowed between characters.  Any characters beyond 11 are
  505.      ignored.   The  characters can be specified as lowercase and will
  506.      be converted to uppercase automatically.
  507.  
  508.      The  volume  name  is  normally  written  on  the  disk  during a
  509.      format.   Since the volume name is optional to MS-DOS, it may not
  510.      appear  in  the root directory of the disk.  When the volume name
  511.      is  not  availiable,  the  MS-DOS  File  System will use the boot
  512.      block  identification  name  and  a   creation date of January 1,
  513.      1980 as the volume information for AmigaDOS.
  514.  
  515.           "IBM  3.1:FILENAME.EXT"     =>  DI0:FILENAME.EXT
  516.  
  517. DIRECTORY NAME QUALIFIERS ('/' or '\')
  518.      The  directory  name  qualifiers can be the standard AmigaDOS '/'
  519.      or  MS-DOS  '\'  characters.  The characters '/' and '\' are used
  520.      to  separate  directory  paths.   A path name qualifier without a
  521.      file  or  directory  name immediately preceding it will specify a
  522.      parent  directory.   This  follows  the convention established by
  523.      AmigaDOS.
  524.  
  525.           DI0:SUBDIR/FILENAME
  526.  
  527.           DI0:SUBDIR\SUBSUBDIR/FILENAME
  528.  
  529.           DI0:SUBDIR\SUBSUBDIR//      =>  DI0:SUBDIR
  530.  
  531. FILE FILTERS
  532.      Normally  the  MS-DOS  File  System will transfer data unmodified
  533.      between  the MS-DOS device and the Amiga.  There may be occasions
  534.      where  certain  file translating (filtering) may be desired.  Two
  535.      types  of  filtering  provided  by  the  MS-DOS  File  System are
  536.      availiable to you as options.
  537.  
  538. CTRL-M/CTRL-Z Filter (']')
  539.      MS-DOS   text  files  normally  have  carriage  returns  (CTRL-M)
  540.      followed  by  linefeeds  (CTRL-J)  whereas  the  Amiga only needs
  541.      linefeeds.   They also place one or more EOFs (CTRL-Z) at the end
  542.      of  the  file to signal the end-of-file which is also not used by
  543.      the  Amiga.  If you wish to filter the carriage returns and EOFs,
  544.      place   the  character  ']'  anywhere  in  the file specification
  545.      (append  to  the end of the name works best).  The filter removes
  546.      carriage  returns  and EOFs when reading the file from the MS-DOS
  547.      device.   The  filter  will add carriage returns before linefeeds
  548.      and  an  EOF to the end of the text when writing the file  to the
  549.      MS-DOS disk.
  550.  
  551.           DI0:SUBDIR/FILENAME.EXT]    =>  DI0:FILENAME.EXT
  552.                                  /* with CTRL-M/CTRL-Z Filter on */
  553.  
  554. HIGH BIT FILTER ('[')
  555.      Some  MS-DOS  word  processing  files set the high bit of ceratin
  556.      ASCII  characters  in  the  file  to  give that character special
  557.      meaning.   If  you  wish to filter the high bit to try to conform
  558.      the  file  to   standard  ASCII  text,  place   the character '['
  559.      anywhere  in  the  file  specification  (append to the end of the
  560.      name  works  best).   The  filter  only  clears the high bit when
  561.      reading  the  file  from  the MS-DOS device.  The filter will not
  562.      set the high bit when writing the file to the MS-DOS device.
  563.  
  564.           DI0:SUBDIR/FILENAME.EXT[    =>  DI0:FILENAME.EXT
  565.                                    /* with High bit Filter on */
  566.  
  567. NOTE
  568.      Some   CLI   utilities   may  use  '['  or  ']'  as  special
  569.      characters.   The utility should have an escape (or literal)
  570.      character (such as '*') to precede these characters.
  571.  
  572. SENSING DISK CHANGES
  573.      The  MS-DOS  File  System  will automatically detect disk changes
  574.      and    modify   the  system  parameters  if  the  drive  used  is
  575.      compatible  with  Amiga  hardware  requirements  for  disk change
  576.      detection.   The 3 1/2" drive supplied with your Amiga is capable
  577.      of  disk  change  detection,  whereas  most 5 1/4" drives sold by
  578.      Commodore-Amiga are not.
  579.  
  580.      For  those  drives  that  do  not  have  hardware  to detect disk
  581.      change,  the  "diskchange" command (provided in AmigaDOS versions
  582.      1.2  and  1.3)  can  be used to "force" the MS-DOS File System to
  583.      recognize a change of disks.
  584.  
  585. WORKBENCH USAGE
  586.      The  MS-DOS  File System will operate properly with WorkBench but
  587.      some points must be covered.
  588.  
  589.      If  you  use WorkBench exclusively over the CLI, you will want to
  590.      configure  any  MS-DOS  devices  to  be  loaded  immediately when
  591.      mounted   (ie.  Mount  =  1).   If  this is not done, executing a
  592.      directory  command  on the device from CLI will bring up the disk
  593.      icon on WorkBench.
  594.  
  595.      Avoid   using  the  "KILL"  utility.   Using  it  will  free  the
  596.      resources  and  memory  used  by  the  filesystem  but will crash
  597.      WorkBench.
  598.  
  599.      Create  files  on  the  MS-DOS  disk  with NO file extension (ie.
  600.      characters  following  the '.').  Applications that automatically
  601.      create ".info" files will then work correctly.
  602.  
  603. FILE LIST
  604.      This is the current listing of the CrossDos distribution disk:
  605.  
  606.           PD (dir)
  607.             arp13.zoo        ARP V1.3 library and commands
  608.             arpqr.arc        ARP V1.3 "quick reference" guide
  609.  
  610.           c (dir)
  611.             Mount            V1.3 compatible cmd to "mount" device
  612.             TDPatch12        trackdisk.device patch for V1.2
  613.             TDPatch13        trackdisk.device patch for V1.3
  614.  
  615.           L (dir)
  616.             MSDOSFileSystem  MS-DOS file system code
  617.  
  618.           Devs (dir)
  619.             mfm.device       mfm device driver code
  620.             mountlist.msdosFS  partial mountlist for floppies
  621.  
  622.           LIBS (dir)
  623.             arp.library      ARP V1.3 library
  624.  
  625.           Utilities (dir)
  626.             cmpPATH          execution script to exercise filesystem
  627.             devinfo          display device info (internal use)
  628.             diskchk          check disk blocks
  629.             diskchk.info
  630.             kill             kill handler or filesystem
  631.             MFormat          format utility for MS-DOS disks
  632.             MFormat.info
  633.             MDiskCopy        diskcopy utility for MS-DOS disks
  634.             MDiskCopy.info
  635.  
  636.        CrossDOS.manual       The manual for this product
  637.        Install_msdosFS       execution program for auto-installation
  638.        Install_msdosFS.info
  639.        READ.ME               last minute news and updates.
  640.  
  641. MS-DOS FILE SYSTEM SUPPORT UTILITIES
  642.      The  following sections describe the utilities included with this
  643.      product that are unique.
  644.  
  645. "KILL"
  646.      Format: KILL <devicename>
  647.  
  648.      Template: KILL "DEVICENAME"
  649.  
  650.      Purpose: To remove a filesystem and free resources
  651.  
  652.      Path: C:KILL
  653.  
  654. SPECIFICATION:
  655.      This  utility  attempts  to  KILL  the MS-DOS File System that is
  656.      loaded.   It  will  try  to  return  all the resources and memory
  657.      allocated.
  658.  
  659.      Caution  must  be  exercised  in using this command since it does
  660.      not  check  to  make  sure all the file Locks are returned to the
  661.      filesystem  before KILLing it.  If file Locks still exist (ie. if
  662.      a  directory in filesystem is still the current directory for the
  663.      CLI  being  used) after KILLing the filesystem, you may crash the
  664.      system.
  665.  
  666.      Using   this   utility   when  WorkBench  is  loaded  will  crash
  667.      WorkBench.  To recover, issue a "LoadWB" command again.
  668.  
  669.      KILL  may work with other filesystems but we do not guarantee the
  670.      results.
  671.  
  672. "DISKCHK"
  673.      Format: DISKCHK <devicename>
  674.  
  675.      Template: DISKCHK "DEVICENAME"
  676.  
  677.      Purpose: To check the read integrity of any disk
  678.  
  679.      Path: C:DISKCHK
  680.  
  681. SPECIFICATION:
  682.      This  utility attempts to check the read validity of any disk and
  683.      report any errors.
  684.  
  685.      It  will  interactively  ask  which  blocks  to check ( lower and
  686.      upper  limits).   If  the  character "r" is place after the upper
  687.      limit  value  entered, DISKCHK will "repeat" the checking until a
  688.      Control-C is typed.
  689.  
  690.      This  utility  was  originally  design  to  check MS-DOS formated
  691.      disks but it should work on any disk mounted on the Amiga.
  692.  
  693. "MFORMAT"
  694.      Format: MFORMAT   DRIVE  <devicename>  NAME  <diskname> [QUICK]
  695.  
  696.      Template: MFORMAT "DEVICENAME,DISKNAME,QUICK/S"
  697.  
  698.      Purpose: Format a disk using an MS-DOS format
  699.  
  700.      Path: C:MFORMAT
  701.  
  702. SPECIFICATION:
  703.      This  utility  will  format a disk an MS-DOS format using some of
  704.      the parameters in the mountlist.
  705.  
  706.      The  QUICK  option  will  only  reformat  a  previously formatted
  707.      MS-DOS  disk.   It  will supply a new boot block, file allocation
  708.      tables and empty root directory.
  709.  
  710. "MDISKCOPY"
  711.      Format: MDISKCOPY
  712.  
  713.      Template: MDISKCOPY
  714.  
  715.      Purpose: Make a copy of an MS-DOS disk
  716.  
  717.      Path: C:MDISKCOPY
  718.  
  719. SPECIFICATION:
  720.      This  utility  will  make  a  copy  of  an MS-DOS disk on another
  721.      drive.
  722.  
  723.      It  will interactively ask which is the SOURCE drive and which is
  724.      the DESTINATION drive.
  725.  
  726.      Remove at least one of the disks after completing the command.
  727.  
  728. "TDPatch"
  729.      Format: TDPatch12 or TDPatch13
  730.  
  731.      Template: TDPatch12 or TDPatch13
  732.  
  733.      Purpose: Patch the trackdisk.device for V1.2 or V1.3
  734.  
  735.      Path: C:TDPatch12 or TDPatch13
  736.  
  737. SPECIFICATION:
  738.      This  utility  will patch the trackdisk.device for Kickstart V1.2
  739.      or  V1.3.   This patch is only needed if there is only one 3 1/2"
  740.      drive  in  your  system.   There  are a few bugs in the trackdisk
  741.      code that manifest itself only under certain conditions.
  742.  
  743.      The  installation  program  should  detect your Kickstart version
  744.      and  apply  the  proper  patch  if  your  system  meets the other
  745.      criteria.
  746.  
  747. "CmpPATH"
  748.  
  749.      Format: Execute CmpPATH <srcpath> <dstpath> [CMPONLY]
  750.  
  751.      Template: CmpPATH "SRCPATH,DSTPATH,CMPONLY/S"
  752.  
  753.      Purpose: Special exerciser for multiple DOS functions
  754.  
  755.      Path: C:CmpPATH
  756.  
  757. SPECIFICATION:
  758.      This  execution  script will execute a series of DOS utilities to
  759.      test many of the DOS functions a filesystem should perform.
  760.  
  761.      The  ARP  commands  MUST  be  used  with  this  script.   The ARP
  762.      commands should be placed in the C: directory.
  763.  
  764.      SRCPATH is the source path from which files will be copied.
  765.  
  766.      DSTPATH is the destination path to which files will be copied.
  767.  
  768.      The DSTPATH will be modified but the SRCPATH will not.
  769.  
  770.      The  CMPONLY  option will not modify the DSTPATH but only compare
  771.      the files between the two paths.
  772.  
  773.      Presently   DOS   utilities   such  "cd",  "setdate",  "makedir",
  774.      "rename", "protect", "delete" and "cmp" are used in the script.
  775.  
  776. TECHNICAL SPECIFICATIONS
  777.      The  following are the technical specifications of the filesystem
  778.      and device driver.
  779.  
  780. MSDOSFILESYSTEM
  781.      The  Amiga  allows  for  foreign device (disk) formats as well as
  782.      the  standard  AmigaDOS disk format by placing a common interface
  783.      (DOS  interface)   between  the  application  and the file system
  784.      (handler).   The  file  system  code that understands the foreign
  785.      disk  format  must  conform to at least a minimum set of commands
  786.      from this DOS interface.
  787.  
  788.      The  MS-DOS  File  System  code  translates the DOS commands into
  789.      MS-DOS  disk  format specific reads and writes to the device.  If
  790.      the  device  is  a floppy disk, the file system is initialized to
  791.      open  the  "mfm.device"  to translate raw data from the disk into
  792.      data  blocks  and vice versa.  Other devices can be used by using
  793.      the   device  driver  code  supplied  by  the  device  controller
  794.      manufacturer.
  795.  
  796. DEVS:mfm.device
  797.      The  "mfm.device"  is  used  to  decode  and  encode  "mfm"  data
  798.      physically  formatted  in a standard (non-Amiga) format.  It acts
  799.      just  like  the  Amiga-supplied  "trackdisk.device" device driver
  800.      code.   It  answers requests for drive control and blocks of data
  801.      transfer.
  802.  
  803.      The  "mfm.device"  responds  to all the command types as does the
  804.      "trackdisk.device" with the following exceptions:
  805.  
  806.        -  EXT (Extended) command qualifiers are not valid.
  807.  
  808.        -  A  new  command MDCMD_SETPARMS = 22 is included to allow the
  809.           device  driver  to  set some of the physical disk parameters
  810.           to  new  values.   The  FileSysStartupMsg  Environment Table
  811.           pointer   is   passed  in  io_Data.   Any  errors  are
  812.           returned in io_Error.
  813.  
  814. The end.
  815.